home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
f90
/
pxfgetarg.z
/
pxfgetarg
Wrap
Text File
|
1998-10-30
|
3KB
|
62 lines
PXFGETARG(3F) Last changed: 1-6-98
NNAAMMEE
PPXXFFGGEETTAARRGG - Returns a command-line argument
SSYYNNOOPPSSIISS
CCHHAARRAACCTTEERR**_n _b_u_f
IINNTTEEGGEERR _m,, _i_l_e_n,, _i_e_r_r_o_r
CCAALLLL PPXXFFGGEETTAARRGG((_m,, _b_u_f,, _i_l_e_n,, _i_e_r_r_o_r))
IIMMPPLLEEMMEENNTTAATTIIOONN
UNICOS, UNICOS/mk, and IRIX systems
DDEESSCCRRIIPPTTIIOONN
On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
default when compiling programs with the MIPSpro 7 Fortran 90 compiler
or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
7.2 F77 compiler.
The PPXXFFGGEETTAARRGG subroutine examines the command line used to invoke the
executing program and returns the _mth command-line argument in _b_u_f.
When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
kind unless documented otherwise. On UNICOS and UNICOS/mk, default
kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
IRIX, the default kind is KKIINNDD==44.
This routine has the following arguments:
_m An input integer variable or array element containing the
number of the command-line argument to return in _b_u_f. If _m is
zero, the command name is returned in _b_u_f.
_b_u_f An output character variable or array element containing the
_mth command-line argument.
_i_l_e_n An output integer variable containing the significant length
in characters of the string stored in _b_u_f. If the length of
the string is shorter than the length of _b_u_f, the shorter
length is returned. If the string is longer, the longer
length of the string is returned.
_i_e_r_r_o_r An output integer variable containing 0 if a value is returned
in _b_u_f or containing the following:
EEIINNVVAALL If _m is out of range
EETTRRUUNNCC if the declared length of _b_u_f is insufficient to
contain the string to be returned. The value of the
command-line argument is truncated to fit in _b_u_f,
and _i_l_e_n is set to the full length of the original
string.
SSEEEE AALLSSOO
IIPPXXFFAARRGGCC(3F)
_A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
2165, for the printed version of this man page.